home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / archiver / zipspl12.zip / ZIPSPLIT.DOC < prev    next >
Text File  |  1992-08-27  |  8KB  |  242 lines
  1.          ZIPSPLIT  Split Utility for PKZIP (tm)  Version 1.2  08-27-92
  2.  
  3.                     FreeWare (C) 1990-1992 Jon Harald Holm
  4.  
  5.  
  6.  
  7. ZipSplit split ZIP files into smaller ZIP files.  This is useful when
  8. taking backup of large ZIP files onto floppy disks.
  9.  
  10. ZipSplit is FreeWare.  Anyone is allowed to use ZipSplit for free and
  11. at own risk (ZipSplit is not guaranteed to be bug free).  You don't
  12. have to pay me anything!  Please distribute ZipSplit as the original
  13. ZIP file and take no more than a nominal charge for handling only (no
  14. profit).
  15.  
  16. Do you have any comments?
  17.  
  18. My address:    Jon Harald Holm
  19.                Klostergata 3
  20.                0656 Oslo
  21.                     Norway
  22.  
  23. Email:         jonhar@solan.unit.no
  24.  
  25.  
  26.  
  27.  
  28. Files in the package:
  29. ---------------------
  30.  
  31. zipsplit.exe          The split programme.
  32. zipsplit.doc          This file!
  33. history.txt           Text file explaining the version history.
  34. zipspl30.pif          PIF file for Microsoft Windows 3.0
  35. zipspl21.pif          PIF file for Microsoft Windows 2.1
  36.  
  37.  
  38. Installation:
  39. -------------
  40.  
  41. You can copy the files anywhere you like.  ZipSplit don't need any
  42. environment variables.
  43.  
  44. If you want to use a PIF file, remember to edit the 'Program Filename'
  45. in the PIF Editor. I recommend you rename the PIF file you want to use
  46. to ZIPSPLIT.PIF.
  47.  
  48.  
  49. Usage:
  50. ------
  51.  
  52. If you just type zipsplit ('Enter'), you will get this output:
  53.  
  54. ----------------------------------------------------------------
  55. ZIPSPLIT  Split Utility for PKZIP (tm)  Version 1.2  08-27-92
  56. FreeWare (C) 1990-1992 Jon Harald Holm      ZIPSPLIT for help
  57.  
  58. Usage:  ZIPSPLIT source[.ZIP] target {[size|disk]}
  59.  
  60. source  =  name of file to split
  61. target  =  target filename
  62. size    =  split size in kB
  63. disk    =  one of the predefined disk sizes; D360 D1.2 D720 D1.4
  64. ----------------------------------------------------------------
  65.  
  66. Maybe this is not enough help in the beginning, so I will explain each
  67. argument in detail.
  68.  
  69. source:
  70. This is the source filename.  If you don't include any extension,
  71. ZipSplit assumes the extension to be ZIP.  The filename may include
  72. wildcards.
  73.  
  74. target:
  75. The target may consist of a drive, a path and a filename. Where the
  76. drive and path (if included) indicates where to store the files. The
  77. filename is the name you want to give your split files.  Each split
  78. file will get a number in the end of the filename to distinguish them
  79. from each other.  Your name will be truncated to give room for this
  80. number if necessary.  If you don't include any extension, ZipSplit
  81. will add ZIP.
  82.  
  83. size:
  84. If you use this argument, then you can't use the 'disk' argument.
  85. 'size' is a number which indicate the size in kB of each split file.
  86.  
  87. disk:
  88. This is just a predefined size.  It is used to split in sizes which
  89. fits exactly onto diskettes, e.g. you want to store the files on 3.5"
  90. HD diskettes, then you choose D1.4 as argument.
  91.  
  92. You may give as many size|disk arguments as you like. ZipSplit will
  93. make a split file for each size. The last size|disk argument will be
  94. the default size. The default size is used when a split file is made
  95. for each size|disk argument but still more split files are needed.
  96. E.g. 'zipsplit test test d720 d1.4' will give one file which fits a
  97. 720 kB floppy and the rest of the files will fit 1.44 MB floppys.
  98.  
  99. If you don't use 'size' or 'disk', then all available space on the
  100. target disk will be used.
  101.  
  102. When the target disk don't have any more space, you will be prompted
  103. to change floppy disk or you may type in another target disk letter.
  104.  
  105.  
  106. Examples:
  107. ---------
  108.  
  109. I will give two examples to remove any doubts about the use of ZipSplit.
  110.  
  111. 1)  Split the file to the C drive in chunks that fits 720 kB floppy disks:
  112.  
  113. -------------------------------------------------------------
  114. C:\TOOLS>zipsplit c:\test test d720
  115.  
  116. ZIPSPLIT  Split Utility for PKZIP (tm)  Version 1.2  08-27-92
  117. FreeWare (C) 1990-1992 Jon Harald Holm      ZIPSPLIT for help
  118.  
  119. Searching ZIP: C:\TEST.ZIP - Test ZIP file of 1137150 bytes
  120.   1)  TEST1.ZIP
  121.       Size:  730070      Fill: 100%
  122.   2)  TEST2.ZIP
  123.       Size:  407151      Fill:  55%
  124. -------------------------------------------------------------
  125.  
  126.  
  127. 2)  Split the file to the diskettes in the A and B drive:
  128.  
  129. -------------------------------------------------------------
  130. C:\TOOLS>zipsplit c:\t* a:test
  131.  
  132. ZIPSPLIT  Split Utility for PKZIP (tm)  Version 1.2  08-27-92
  133. FreeWare (C) 1990-1992 Jon Harald Holm      ZIPSPLIT for help
  134.  
  135. Searching ZIP: C:\TEST.ZIP - Test ZIP file of 1137150 bytes
  136.   1)  A:TEST1.ZIP
  137.       Size:  730070      Fill: 100%
  138.  
  139. Not enough space on target disk!
  140. Either enter the name of another target disk drive or if the
  141. target disk is a floppy, insert a new floppy. Then press 'Enter' => b
  142.  
  143.   2)  B:TEST2.ZIP
  144.       Size:  353239      Fill:  99%
  145.  
  146. Not enough space on target disk!
  147. Either enter the name of another target disk drive or if the
  148. target disk is a floppy, insert a new floppy. Then press 'Enter' => ('Enter')
  149.  
  150.   3)  B:TEST3.ZIP
  151.       Size:   53983      Fill:  14%
  152. -------------------------------------------------------------
  153.  
  154.  
  155. Miscellaneous:
  156. --------------
  157.  
  158. ZipSplit can't split ZIP files to whatever size you want.  This is
  159. because each file inside the ZIP file must be in one file.  If you
  160. want to split into 100 kB files, and one file in the ZIP file is 110
  161. kB then one split file will be bigger than 100 kB.  Ref. "Program
  162. messages" below.
  163.  
  164. ZipSplit will store the largest file in a ZIP file first.  If you
  165. split to diskette and don't use any size argument, use the diskettes
  166. with largest free space first.
  167.  
  168. The 'Fill' message after each ZIP file indicate how many percent of
  169. the given size (rounded up to nearest 1024) have been used.  Did you
  170. not give any size, this percentage indicates how much of the disk free
  171. space you have used.
  172.  
  173. If you add the sizes of the split files, you will see that it is
  174. larger than the size of the original file.  This is because each split
  175. file is a ZIP file, and includes the ZIP format data.
  176.  
  177.  
  178. Program messages:
  179. -----------------
  180.  
  181. * Not enough space on target disk!
  182.   Either enter the name of another target disk drive or if the
  183.   target disk is a floppy, insert a new floppy. Then press 'Enter' =>
  184.  
  185. The target disk is full!  Is it a floppy then you may change floppy
  186. and press 'Enter'.  Otherwise you can type in a new drive letter and
  187. press 'Enter'.
  188.  
  189.  
  190. * Can't be made smaller
  191.  
  192. The ZIP file include a file which is larger than the size given.
  193. (See miscellaneous.)
  194.  
  195.  
  196. * ERROR:  File <file> not found.
  197.  
  198. ZipSplit can't find the source file.  Check if the path is correct spelt!
  199.  
  200.  
  201. * ERROR:  Undefined argument size.
  202.  
  203. The last arguments on the commandline can't be recognized as a number
  204. or as a predefined disk size.
  205.  
  206.  
  207. * ERROR:  <file> is not a ZIP file.
  208.  
  209. The source file can't be recognised to have the ZIP format.
  210. ZipSplit can only split ZIP files, but the extension don't have to be ZIP!
  211.  
  212.  
  213. * ERROR:  Not enough memory.
  214.  
  215. The amount of memory ZipSplit uses depend on the number of files in
  216. the ZIP file (not the size of the ZIP file).  If you get this error
  217. message, then I suggest you manually split the file in two (pkunzip,
  218. pkzip) and then use ZipSplit.
  219.  
  220.  
  221. * ERROR:  Can't open file <file>.
  222.  
  223. ZipSplit can't open the source file!  ZipSplit reads the source file
  224. twice.  You get this message if you remove the source file after it
  225. was located the first time.
  226.  
  227.  
  228. * ERROR:  Target disk failed.
  229.  
  230. ZipSplit can't estimate the free space on the target disk.  Something
  231. must be wrong about the disk (drive)!
  232.  
  233.  
  234. * ERROR:  Can't create file <file>
  235.  
  236. ZipSplit can't create the target file.
  237.  
  238.  
  239. * ERROR:  Can't close <file>
  240.  
  241. ZipSplit can't close the target file.
  242.